# Windows x64 免安装测试版

0.4.14 适合在 Intel 或 AMD 的 Windows 11 电脑上测试。复制 ZIP 后，右键「全部解压缩」，打开解压后的 `Monitor Calibration` 文件夹，双击 `Monitor Calibration.exe`。保留同目录下的 `resources`、DLL 和其他文件。包内包含 Electron、Python、LibRaw/RawPy 和 LittleCMS。测试电脑无需另装运行环境。

## 跑一轮测量

1. 让 iPhone 和 Windows 电脑连到同一局域网，用手机 App 扫 Windows 端二维码。若 Windows 防火墙询问，允许应用通过你信任的专用网络。如果扫码不通，展开「手动配对」，输入电脑的局域网地址、端口和 4 位配对码。准备页会显示手机里已有的基准名称，选「匹配目标屏」即可复用。
2. 使用扩展模式。在目标屏关闭 HDR、夜间模式和自动色彩管理（若有）。如 App 提示 Windows 显示校准加载未启用，按 Win+R 输入 `colorcpl`，在「高级 → 更改系统默认值 → 高级」中检查「使用 Windows 显示校准」。App 会重新检查状态。该设置由 Windows 管理，若需要管理员授权由你在系统中确认。
3. 选目标屏和实际屏幕模式。点「显示白色并继续」，确认白色出现在目标屏。固定手机，对准后在手机上锁定并开始。白场试拍会提示如何对齐亮度；随后完成 52 色采集、ICC 生成与临时应用复测。直到结果页出现再移开手机。测量中可以按 Esc 停止。
4. 复测通过后，结果页可以直接「应用到〈目标屏〉」或「导出 ICC」。应用后检查另一块屏没有变化，再点「恢复应用前 ICC」确认能恢复。连接页「直接选定 ICC」也能选择外部文件或恢复 Windows 系统默认配置。

Windows 实体屏输出和跨登录、拔插的曲线持久化仍待验证。首轮支持 SDR 与传统 VCGT 校准路径。若系统安装 ICC 时明确报权限不足，可用管理员身份重新打开应用。若报错，请记录发生在哪一步，通过「文件 → 导出 Windows 诊断」保存诊断。测试包没有 Windows 发布者签名，Windows 可能显示未知发布者。

当 Windows 默认 ICC 带 MHC2 或 MS00 硬件校准标签时，App 会复制其色彩描述，去除校准标签以生成临时 SDR 测量配置。正常结束、取消或重启恢复时会切回测量前的 ICC。MHC2 的恢复通过系统配置关联确认，显卡曲线仍需实体屏验证。此路径使用自动复测，结果页的匹配前后预览暂不可用。

0.4.11 给 Windows 的 ICC 切换和恢复留出最多 30 秒。若操作超时，App 会尝试恢复原配置，并记录停在哪一步。可从「文件 → 导出 Windows 诊断」查看。

0.4.12 先让目标屏启用当前用户的 ICC，再关联新配置。切换失败时，App 会保留最近一次失败记录到数据目录里的 `windows-icc-last-error.json`。

0.4.13 使用目标屏的 Windows 设备键切换当前用户 ICC 设置。设备键通过目标屏的接口路径核对。

0.4.14 优先读取生成的 ICC v2 文件中的 Unicode 名称。历史结果重新打开后可恢复中文名称。只读取 ICC v2 ASCII 字段的工具会对新生成的文件显示英文备用名。

0.4.16 新增彩色 ICC。打开旧测量的「匹配结果」，确认目标屏的输入、模式及亮度与采集时一致，点「复用采集数据生成并复测彩色 ICC」。在同一部 iPhone 锁定基准曝光后开始短复测，通过后可应用。便携包内的「Windows-颜色对照.png」可在 Windows「照片」中用于目视对照。

兼容性按 Windows 版本、GPU 驱动及显示模式组合验收。Windows 11 x64 上的 Intel Arc B580 和 P2710V 已通过一次 SDR 匹配及光学复测，并应用了生成的 ICC。AMD、NVIDIA 和其他 Windows 版本尚待验证。退出 App、重新登录及拔插后的持久性分别验证。

数据默认保存在 `%APPDATA%\monitor-calibration-desktop`。在 App 的「测量记录与工具 → 打开数据目录」可找到原片和报告。每轮预留约 1 GB 磁盘空间。移走解压目录后，历史记录仍在该数据目录。

## 从源码重新打包

Mac 和 Windows 都可以运行打包脚本。只有构建电脑需要 Node.js 24 LTS、Python 3.13（带 pip）、uv 和可解压 `.tar.zst` 的 `tar`。首次构建要联网下载锁定版本的运行时和依赖。

在 Windows 用 PowerShell 打开项目根目录（能看到 `desktop` 和 `scripts` 两个文件夹）。安装上述工具并重开终端后执行：

```powershell
npm.cmd ci --prefix desktop
py -3.13 scripts/build-windows.py
```

如果 Python 安装方式没有提供 `py`，可用 `python --version` 确认是 3.13 后改跑 `python scripts/build-windows.py`。Mac 上对应命令是 `npm ci --prefix desktop` 和 `python3.13 scripts/build-windows.py`。成品位于 `build/desktop-windows/Monitor-Calibration-Windows-x64-Portable.zip`。每次成功打包会替换该 ZIP 和校验文件，清理临时解包目录。

Mac 打包后，可运行 `python3.13 scripts/push-windows.py win-ssh` 将测试版推送到 PC。更新前关闭 PC 上的 Monitor Calibration。脚本通过 SSH 比较文件校验值，只上传有变化的文件，在 PC 上校验完整目录后替换旧版。始终从 Downloads 下的 `Monitor-Calibration-Windows-x64-Portable\Monitor Calibration\Monitor Calibration.exe` 启动。
